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The Print Service 


Objectives 

Upon completion of this lesson, you will be able to: 

■ Describe the five functions of the LP print service. 

■ Recall the function of a print server and a print client. 

■ Verify that a printer type exists in the terminfo database. 

■ Turn off banner-page printing. 

■ Diagram local and remote print models. 

References 


SunOS 5.1 Setting Up User Accounts, Printers, and Mail, 

Chapter 3, "Setting Up Printers," and Chapter 4, "Routine Printer 
Administration" 
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Introduction 


This lesson introduces the features of the Solaris® l.x print system and 
the terms and concepts needed to configure local and remote printers. 

Configuring local and remote printers is done using Administration 
Tool's Printer Manager. (This is covered in the next lesson.) 
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The LP Print Service 


Overview 


The Solaris 'l.x environment uses the System V-based LP print service 
vv^hich consists of several daemons that monitor print requests, a 
hierarchy of configuration files in the /etc/Ip directory and set of Ip 
commands. 


Features 

m Interoperates with SunOS^*^ 4.1.x-based printers which uses the 
BSD-based print service) 

B Includes bundled PostScript® filters 

H Supports printing forms 

■ Supports print wheels and alternate character sets 

■ Provides flexible printer management, including: 
m Print job priorities 

B Printer classes 
B Selected printer access 


The Print Service 
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Configuring Printer Services 


Configuring printer services in the Solaris 2.x environment involves 

essentially three main tasks: 

■ Set up the printer 

H Physically connect the printer to the system. 

■ Set the printer switches and other settings. 

■ Set up the print server 

a A print server is a system with a printer connected to it. 

n A print server is configured to provide access to the local 
printer using Administration Tool. 

■ Set up the print client 

H A print client is a system that uses a print server for 
printing. 

■ A print client is configured to provide access to the remote 
printer using Administration Tool. 
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Print Service Functions 


■ Queuing 

When print requests are spooled, the jobs are lined up with other 
jobs waiting to be printed. This process of lining up jobs is called 
queuing. 

■ Tracking 

The print service tracks the status of every job to allow users to 
remove jobs and system administrators to manage jobs. For the 
same reason, jobs that were interrupted by something like a 
system crash wUl be resumed when the system reboots. 

m Fault Notification 

When problems occur in the print service, error messages are 
displayed on the system console or mailed to the system 
administrator. 


■ Initialization 

The print service initializes a printer before sending it a print job 
to ensure it is in a known state. 

■ Filtering 

Certain complex print jobs, such as CAD documents, are 
converted into descriptions the printer can understand. 
Conversions are perfonned by programs called filters. 


The Print Service 
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Print Service Terminology 


Print Forms 

A pre-printed form with text and graphics such as an invoice, blank 
check, or letterhead that users want to print on rather than blank 
paper 


Print Wheel and Alternate Character Sets 

Print wheels (or print balls) and font cartridges are referred to as 
hardware character sets and require operator invention to mount them 
when needed. 

Software characters sets that come pre-programmed with the printer, 
such as a non-Postscript printer, must be pre-defined by the 
administrator as a specific font style. Then the user prints a file with 
the font style as an option. 

Selectable character sets may be available with a supported printer 
type, and would be listed in the terminfo database. 

The terminfo database consists of a series of files that describe control 
sequences for initializing printers and terminals. 

The following section identifies printer concepts and models that are 
needed to set up the printing environment. 

■ Printer types 

■ File content types 

■ Filters 

■ Interface programs 

■ Local and remote print models 
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Printer Types 


The printer type is used to identify the terminf o database entry 
containing the control sequences to initialize the printer. This database 
contains a large number of entries, which for most cases means there is 
no need to create additional printer entries. 

Supported printer t 5 q?es include PS (for PostScript), PSR (for PostScript 
Reverse), and non-PostScript types such as daisy, datagraphix, and 
diablO. 

To check if an printer entry exists in the terminf o database, turn to 
the Accounts, Printers, and Mail guide to verify that your printer is 
listed in the Frequently Used PostScript and Non-PostScript printers 
tables. 

Or, list the contents of the /usr/share/lib/terminfo subdirectories. 
# Is /usr/share/lib/terminfo/e 

. . . epson2500 epson2500-80 epson2500-h espson2500-hi80 


The terminfo entry has a name with the same initial letter or digit as 
the abbreviation of the printer. 

Check if the printer can emulate another printer type if there is no 
entry in the terminfo database following the instructions listed on 
page 114 of the above mentioned guide 

See pages 135-138 for a listing of frequently-used printers and their 
associated printer types in the SunOS 5.1 Setting Up User Accounts, 
Printers, and Mail guide. 
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Content Types 


Every print request consists of at least one file containing information 
with a particular format, called a content type. 

Every printer must be defined with a printer type and at least one 
content type. The print service uses this configuration information to 
match a print request to a printer that accepts that type of print 
request. 

This is how it works: 

If you have a PostScript printer, specify that the content type is 
PostScript. This way, users can print PostScript and other supported 
content types to this printer without specifying the content type. 

The only time a user needs to specify a content type when printing a 
file is if it needs special filtering so the printer know what filtering 
needs to be done. 

Some of the supported content types are: 

■ PS (PostScript) 

■ simple 

■ raster 

■ troff 

■ any 

The most important point to remember about content types is to 
associate your printers with the appropriate content types. This is 
easily handled using the Printer Manager because you can select the 
content type from a menu. 
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Print Filters 


Print filters are programs used by the print service to convert the 
content of requests to the content accepted by the destination printer. 

A PostScript filter is used to handle printing special cases on 
PostScript printers. For example, the posttek filter is used to convert 
Tektronix graphic files into PostScript. 

The Solaris 2.x release provides a default set of PostScript filters that 
are automatically installed when a PostScript printer is configured 
using the Printer Manager (part of Administration Tool). 

PostScript filter information is stored in several places. 

M The default PostScript filters are stored in the 

/usr/lib/lp/postscript directory. 

H A set of print filter descriptor files are stored in the /etc/lp/f d 
directory. 

H A print filter lookup table of these downloaded filters is stored 
in the /etc/lp/filter.table file. 
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Interface Programs 


Interface programs are usually shell scripts used by the print service to 
set certain default printer settings. 

For example, to turn off banner page printing over the network, 
modify the / etc/Ip/inter faces /printer_name script by changing line 
332 from: 

nobanner="no" 

to 

nobanner=’'yes" 

This script is a copy of standard initialization script, 
/usr/lib/lp/model/standard script, which takes the 
initialization information from the printer type entry in the terminf o 
database. 

The default printer settings are described on page 392 of the SunOS 5.1 
Setting Up User Accounts, Printers, and Mail Guide. 
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The Printing Environment 


The Solaris 2..X release provides a heterogeneous printing environment. 

■ Solaris 2.x print clients served by a Solaris 2.x print server. 

■ Solaris 2.x and SunOS 4.1.x print clients served by a Solaris 2.x 
print server. 

M Solaris 2.x and SunOS 4.1.x print clients served by a SunOS 
4.1.x print server. 


Solaris 2.x print client 



The diagram above illustrates a heterogeneous printing environment 
with local and remote printers configured. 
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The Local Printing Model 
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Overview 

The printing model for local printing in the Solaris 2.x environment is 
illustrated below. 

The Ipsched daemon, the print service scheduler, is responsible for 
tracking all local print requests and updating the Ip database with 
printer information. 

When a print job is submitted via the Ip command, the scheduler 
places a copy of the request in the /var/spool/lp/requests 
directory. 

Next, the Ipsched daemon matches the request contents to the printer 
contents and identifies a filter if a conversion is necessary. When 
filtering is complete, the scheduler waits for the printer to become 
available; then it runs the interface program to initialize the printer 
and downloads the request to the port to which the printer is attached. 
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The Remote Printing Model 


4.1x 


2.x 


Print Servers 

The diagram below represents the remote printing model for Solaris 
2.x print servers. 

Both SunOS 4.1.x (Berkeley Software Distribution, or BSD) and Solaris 
2.x (System V) clients can print to a Solaris 2.x server. 

Each print client and server has at least one IpNet daemon that 
schedules network print requests. 

In the case of a Solaris 2.x (System V) print client, the IpNet process 
connects to the server' listen port monitor, which connects the 
incoming IpNet request to a local IpNet process. Once the request 
has been queued by the local IpNet process, it is sent to the printer by 
the Ipsched daemon. 

In the case of a SunOS 4.1.x (BSD) client, the Ipd daemon connects to 
the server's listen port monitor, which in turn connects the 
incoming request to a local IpNet daemon. The queuing and printing 
of the request is the same as with a Solaris 2.x (System V) client. 
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The Remote Printing Model 


Print Clients 

The diagram below represents the remote printing model for Solaris 
2.x print cHents. 

It is possible for Solaris 2.x print clients to interact with SunOS 4.1.x 
(BSD) and Solaris 2.0 (System V) print servers. 

The processing of print requests on the print chent is almost identical 
to the one described for local printing. The main difference is that the 
Ipsched daemon hands the print request to the IpNet daemon rather 
than downloading it to a local printer. The IpNet daemon is capable 
of establishing a connection with a listen or Ipd process running on 
the print server. 






.X 


j 


4.1.x 
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Summary 





In this lesson, you learned that: 

■ The Solaris 2.x print service is based on the System V LP print 
service and interoperates with the SunOS 4.1.x environment. 

B The print service matches a print request's content type to a 
printer that can print that type of content. 

■ It is not necessary to specify the content of a print request going 
to a remote SunOS 4.1.x printer because the SunOS 4.1.x print 
server performs any conversion that is necessary. 

■ The Solaris 2.x release provides a default set of PostScript filters 
and they are automatically installed when a PostScript printer 
is defined using the Printer Manager. 

■ The Solaris 2.x release supports a heterogeneous printing 
environment. 

B The Ipsched daemon schedules Ip print requests. 

B The IpNet daemon handles network printer requests. 


Hill 
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Exercise 1-1 


Write down your answers to the following questions. 

1. Describe the five functions of the LP print service. 


2. What is a printer filter? 


3. Describe the three scenarios for printing in the Solaris 2.x 
environment. 


4. What processes are involved in passing remote print requests from 
a Solaris 2.x client to a Solaris 2.x server? 
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The Printer Manager 


Objectives 

Upon completion of this lesson, you will be able to: 

S Use Administration Tool's Printer Manager to add a local and 
remote printer to a system. 

H Modify a printer's configuration using Printer Manager. 

H Delete a printer using Printer Manager. 

References 


SunOS 5.1 Setting Up User Accounts, Printers, and Mail, 
Chapter 3, "Setting Up Printers," 
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Introduction 


This lesson describes the procedures for configuring local and remote 
printers using Printer Manager from Administration Tool. 

Configuring local and remote printers manually is covered in 
Appendix B of this module. 
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Setting Up Printing 



Network Access 

If your network of systems is not running Network Information 
Services Plus (NIS+) or the Network Information Services (NIS) 
product, each print clienf s system name and Internet address must be 
in the print server's /etc/inet/hosts file before setting up the print ^ 
servers and print clients. Also, the prinf serv&'s system name and ^ 
Internet address must be in the /etc/inet/hosts file of each print 
client system. 
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Setting Up Print Servers 


Two main steps are needed to set up Solaris 'l.x print servers, which is 
done using Administration Tool. 

1. Identify printer characteristics 

Printer characteristics include printer name, printer type, and file 
content type. 

2. Configure the port monitor and register the network listen service 
These steps are done automatically by the Printer Manager. 
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Setting Up Print Clients 


The Printer Manager on the Solaris 2.x print client is used to do several 
tasks. 

a Identifies the printer and server system to which the printer is 
connected 

■ Defines characteristics of the printer 

■ Configures the port monitor and registers the listen service 
with the port monitor 

A listen port monitor is used to pass remote print requests between 
the print client's and print server's IpNet daemons. Once again. 
Printer Manager will do these steps for you automatically. 


The Printer Manager 
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Local Printing Configuration 


The following steps are used to connect a local printer to the system. 

1. Physically connect the printer to the system. 

2. Set the printer switches and/or configure baud rate, if necessary. 

3. Plug the printer into a power outlet and turn it on. 

4. Define the following printer characteristics with the LP print 
service using the Printer Manager (this is covered on the following 
page). 
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Using Printer Manager 


1. Invoke OpenWindows'^^, if necessary. 

2. Start Administration Tool and click once on the Printer Manager 
icon. 

The Printer Manager from Administration Tool has three top-level 
menus: 






Printer Manager 


( ii/iew v) (Edit 7) (Goto: vT 


(Help-) 


Print Configurations on Host: venus 
Printer Name Printer Server 


Comment 


Default Printen None 


■ View, which is used to show and find printers 

■ Edit, which is used to add, modify, and delete printers 

■ Goto, which is used to change the system on which to view 
or edit printers 

The steps for adding support for local and remote printers are 
described on the following pages. (Both procedures will be used to 
complete the exercise at the end of this module.) 
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Adding a Local Printer 


Select the Add Local Printer option from the Edit menu. Fill out the 

Local Printer form specifying the following information: 

1. A unique printer name (14 character maximum). 

2. An optional comment that helps users identify the printer. 

3. The printer port name (which is /dev/term/a or /dev/tem/b). 

4. The printer type and file content type. (The PostScript filters are 
loaded automatically when a PostScript printer is added.) 

5. Choose the Write to superuser from the Fault Notification menu, 
which is the default setting. The other options are Mail to 
superuser or None. 


Printer Manager: Local Pfinter 

Printer Name: spock _ 

Printer Server: venus 

Comment: postscript printer^ _ 

Printer Port: 0 /dev/term/a 
Printer Type: 0 Postscript 


File Contents: 
Fault Notification: 
System Default: 
Print Banner: 
Register with NiS-i-: 


0 Postscript 
0 Write to superuser 


Yes 

No 


Required 

Not required 

Yes 

No 



User Access List: 



( ftdd^ ( Reset^ ( Help...^ 
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Adding a Local Printer 


6. Set the system default (printer) at Yes, which is the default setting. 

7. Set the print banner setting default to Required, which is the 
default setting. 

8. The Register with NIS+ option allows you to enter the printer 
name in the NIS+ name service database. Leave this option at No, 
which is the default setting. 

9. The User Access List option allows you to deny or allow access to 
the printer on a per-user basis. The default setting is that all users 
can access the printer. 

10. Qick on Add when you have completed the form. 

Dismiss the Local Printer form and return to the Printer Manager 

window. 

The newly added printer is displayed in the Printer Manager window. 


' 1:0 


Pfinter Manager 


( View v) (Tdit v) ( Goto: 




Print Configurations on Host venus 
Printer Name Printer Server 


Comment 


Ispock 


postscript printer 




Default Printer: s 


: spock^ 


The Printer Manager 

Copyright 1993 Sun Microsystems, Inc. All Rights Reserved. SMCC July 1993 


2-9 






Adding Access to a Remote Printer 


Select the Add Access to Remote Printer option from the Edit menu. 
Fill out the Access to Remote Printer form specifying the following 
information: 

1. The printer name. 

2. The printer server name. 

3. An optional comment that helps users identify the printer. 

4. Specify the appropriate printer server operating system: BSD or 
System V. 

{This will depend on the server's operating system in the lab 
environment.) 

5. Specify whether this printer is the default printer. 

6. Qick on Add. 

7. Dismiss the Access to Remote Printer form. 


^ Printer Manager: Access to Remote Printer 


Printer Client: venus 
Printer Name: sparky 


Printer Server: pluto 


Comment: postscript printer^ 
Print Server OS: 


BSD 


System V 


System Default: 


Yes 


No 


( ftdd^ ( Reset) ( Help...^ 
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Adding Access to a Remote Printer 


Verify that access to the remote printer has been added. 


Q Printer Manager 

( View 7') ( Edit v) ( Goto: 7) ^_ 


(Help-) 


Print Configurations on Host: venus 


Printer Name 

Printer Server 

Comment 



[sparky 

pluto 

postscript printer 

1 

spock 

venus 

postscript printer 



Default Printer: spock 
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Managing Printer Queues 


In the Solaris 2.x printer environment, system administrators can 
toggle a printer's ability to accept or reject print requests. Printers can 
also be enabled or disabled from printing print requests. 

When a local or remote printer is added using the Printer Manager, the 
printers are automatically configured to accept print requests and can 
begin printing requests. 

These two features provide a system administrator flexibility in 
managing printer queues. For example, if one printer is overloaded, 
you can have it reject aU new print requests but continue to finish 
existing queued requests. 

You can also disable a printer from printing any requests if it needs to 
be taken off-line for any reason. 

Both of these features can be controlled with the Printer Manager or 
with the accept/re jeql: commands or the enable/disable 
commands. These commands are covered in the next lesson. 
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Managing Printer Entries 


Modifying a Printer Entry 

Use the Modify Printer option from the Edit menu to change an 
existing printer's configuration. 

Focus on the Enable Print Queue and Accept Print Jobs settings. These 
two settings allow you to change a printer's ability to print and/or 
queue print requests. 


Printer Manager: Modify Printer 

Printer Name: spock 
Printer Server: venus 

Comment: postscript printer^ _ 

Printer Port: @ /dev/term/a 
Printer Type: PS 
File Contents: @ Postscript 


Fault Notification: 
System Default: 
Print Banner: 
Register with NIS+: 
Enable Print Queue: 
Accept Print Jobs: 


0 Write to superuser 


Yes 

No 



1 Required 

1 Not required 


Yes 

No 



Yes 

No 



Yes 

No 



User Access List: 





( Apply") ( Reset^ ( Help..,} 


Qick on Apply after making a selection. 
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Managing Printer Entries 


Deleting a Printer Entry 

Printer entries can be deleted by using the Delete Printer option from 
the Printer Manager's Edit menu. 

All currently queued print requests to this printer must be removed 
with the cancel or Ipmove commands before the printer entry can be 
successfully removed. 

It is sometimes necessary to remove a printer entry manually. (This 
procedure is covered in the next lesson.) 


Finding a Printer Entry 


Use the Find option from the Print Manager's View menu if a system 
has a long listing of printers and scrolls off the Printer Manager 
window. 

Once the printer entry is highlighted, you can modify or delete the 
entry. 
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Summary 


In this lesson, you learned that: 

■ If your network of systems is not using a name service product, 
then system names and Internet addresses must be added to the 
print server's and print client's /etc/inet/hosts files before 
setting up print servers and print clients. 

■ System administrators use the Printer Manager to define printer 
characteristics, such as printer name, printer and file content 
types, and whether the printer is local or remote. 

■ The Printer Manager configures the port monitor and registers 
the listen network service automatically. 

■ The Printer Manager is also used to modify, delete, and find 
printer entries. 
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Exercise 2-1 


The purpose of this lab is to use the Printer Manage to add a local or 
remote printer. 


Procedure 

The instructor wUl let you know whether this lab exercise will be a 
group demonstration or whether you should work in teams of two or 
three students, if printers are available for this exercise. 

The instructor will also identify the following information: 

■ Whether a remote SunOS 4.1.x or Solaris 2.x printer is available. 

■ The printer name, if a printer is available. 

It is possible to print to ASCII terminals if they are available from a 
previous lab exercise. 

1. Connect the printer to be configured and ensure it is turned on. 

2. Use the Printer Manager to add a local printer. 

3. Use the Printer Manager to add a remote printer. Ensure remote 
print server and Internet address are added to the 

/etc/inet/hosts file. 

4. Look at the Printer Manager window to verify that the printer has 
been added. 

5. Send a file to the printer. 
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Using LP Commands 



Objectives 


Upon completion of this lesson, you will be able to: 

S Given a case study, write the commands used to set up a 
printer class. 

H Recall how to remove queued print requests. 

H Write the commands used to take a printer out of service and 
then make it available. 

M Manually designate a default printer destination using the 
Ipadmin command. 

m Manually designate a default printer destination using 
environment variables. 

H Write the command to move a queued print request to the top 
of the queue. 

■ Write the commands used to hold a queued print request and 
then resume it. 


References 



SunOS 5.1 Setting Up User Accounts, Printers and Mail, 
Chapter 4, "Routine Printer Administration," and 
Chapter 6, "Setting Printer Policies" 
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Introduction 


Not all printer management tasks can be done using the Printer 
Manager. 

This lesson describes the LP commands needed to manage printer 
administration tasks, such as: 

S Creating printer classes 

■ Managing print queues and printer availability 

■ Stopping and starting the LP print service 
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Basic LP Command Introduction 


The following LP commands are needed to perform the printer 
management tasks described on the following pages. 


Command Name 

Description 

Ip 

Send file to a printer 

Ipstat 

Display print service status 

cancel 

Cancel print requests 

accept 

Enable queuing of print requests 

reject 

Prevent queuing of further print requests 

enable 

Allow printer to print requests 

disable 

Disable printer from printing requests 

Ipmove 

Move print requests 

Ipadmin 

Perform various administrator tasks 


Using LP Commands 

Copyright 1993 Sun Microsystems, Inc. All Rights Reserved. SMCC July 1993 


3-3 

















Printer Terminology 


The Solaris 2.x print service provides two different ways to specify the 
destination of a print request, which is the target for print jobs. 

a Printer 

Print requests can be sent to a printer by its printer name, which is 
assigned by the system administrator. 

H Class 

Print requests can be sent to a group of printers called a class, 
which is a name assigned to a group of printers by the system 
administrator. 
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Using Printer Classes 


A class is a named group of printers created with the Ipadmin 
command. Once created, a class can be used as the destination of 
print requests allowing the print service to automatically select an 
available printer within the class that has a matching content type. 

Printer classes can be defined using different criteria: 

■ Based on printer type (all PostScript printers) 

■ Based on location (first floor, tenth floor. Building 7) 

H Based on work group or department (Accounting or 
Engineering) 

You can create a class of printers to ensure the printers are accessed in 
a particular order, because the print service always checks for printer 
availability, using the order in which the printers were added to the 
class. For example, if you have a high-speed printer, add it to the class 
first so it can handle as many print requests as possible. These rules 
also apply to printer usage order: 

■ Print requests are balanced between printers in a class for local 
printers only. 

R When a print client attempts to print to a class of printers 
defined on a print server, only the first printer defined in the 
class is used. 

A class is created the first time a printer is added to it. Once a class 
has been created, use the accept command to allow the class to 
queue jobs. 

Qasses do not have to be enabled with the enable command. 
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Using Printer Classes 


Example: 

1. Add printers to a class named groiandfloor. Then issue the 
accept command to allow the printer class to accept print 
requests. 


# Ipadmin -p spock -c groundfloor 

# Ipadmin -p sparky -c groundfloor 

# accept groundfloor 

destination "groundfloor" now accepting requests 

# 

2. Check the status of the printer class. 


# Ipstat -t 

scheduler is running 
system default destination: spock 
members of class groundf loor: 
spock 
sparky 

system for spock: venus 
system for sparky: pluto 

groundfloor accepting requests since Tue Jun 8 11:26:21 PDT 
1993 

spock accepting requests since Tue Jun 8 09:42:50 PDT 1993 
sparky accepting requests since Tue Jun 8 09:43:27 PDT 1993 
printer spock is idle, enabled since Tue Jun 8 09:42:50 PDT 
1993. available. 

printer sparky is idle, enabled since Tue Jun 8 09:43:28 PDT 
1993. available. 

# 

3. Send a request to the printer class. 


$ Ip -d groundfloor worldmap.ps 

request id is groundfloor-30 (1 file(s)) 
$ 
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Designating a Default Destination 


A system administrator can designate a printer or class of printers as 
the system-wide default destination for print requests using the 
Ip admin command. 

# Ipadmin -d sparky 

# Ipstat -d 

system default destination: sparky 

# 

This can also be done using the Printer Manager when adding a local 
or remote printer by setting System Default (printer) to yes. 

Individual users can set their own default printer by,, setting the 
LPDEST environment variable with the name of that printer or class. 

Bourne or Korn shell users use: 

$ i:jPDEST=spock 
$ export LPDEST 

$ 

C shell users use: 

venus% setenv LPDEST spock 

venus% 
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Cancelling Print Requests 


Use the cancel command to cancel a print request. Note that users 
are only allowed to cancel their own requests. Only the superuser can 
cancel any request. 

Examples: 

List print requests queued for a specific destination: 


# Ipstat “O 




spock-7 6 

root 

575 

Jun 8 11:28 

spock-77 

root 

4601 

Jun 8 11:28 

spock-78 

root 

1697 

Jun 8 11:28 

spock-79 

riimmer 

575 

Jun 8 11:30 

spock-80 

rimmer 

4601 

Jun 8 11:30 

spock-81 

rimmer 

1697 

Jun 8 11:30 


# 

Cancel specific print requests. 


# cancel spock-77 spock-78 

request "spock-77" cancelled 
request "spock-78" cancelled 

# 

Cancel all print requests submitted by a user. 


# cancel -u rimmer 

request "spock-79" cancelled 
request "spock-80" cancelled 
request "spock-81" cancelled 

# 


3-8 


The Print Seroice 


Copyright 1993 Sun Microsystems, Inc. All Rights Reserved. SMCC July 1993 




Taking a Printer out of Service 


Moving Requests 

The Solaris 1.x print service allows requests to be moved between 
different queues. It does not move requests if their content type does 
not match the content type of the new destination. 

If you decide to take a printer out of service: 

■ Reject additional print requests on the printer to be made 
unavailable. 

■ Move or cancel any requests that are currently queued to the 
printer. 

Requests for a specific printer or form type are not automatically 
moved. If you do not move or cancel them specifically, the print 
service cancels them when the Ipmove command is issued. 

When you move requests, the print request IDs remain unchanged, so 
users can still identify their requests. 
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Moving Requests 
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Use the Ipmove command to move selected print requests or all print 
requests from one printer or printer class to another. 

1. Become superuser on the print server system. 

2. Use the reject command to prevent any further print requests 
from being sent to the print queue while you are moving print 
requests. This step notifies users why the printer is not accepting 
requests. 

# reject -r "spock is down for repairs" spock 

# 

3. List the print queue to see how many print requests are to be 
moved. This step is needed to identify print request IDs if you are 
going to move selected print requests. 

# Ipstat “O 

spock-10 lister 241666 Jun 8 11:42 

spock-11 lister 45133 Jun 8 11:42 

spock-12 lister 50574 Jun 8 11:43 

# 

4. Verify that the destination printer is accepting print requests. 


# Ipstat -p spock 

printer spock is idle, enabled since Wed Jun 8 09:31:26 PDT 1993. 
available. 

# 

5. Move specific or all print requests. 


# Ipmove spock sparky 

# 

or 

# Ipmove spock-11 spock-12 sparky 

# 
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Moving Requests 


6. Use the accept command once the tmavailable printer is available 
again. 

# accept spock 

destination "spock" now accepting requests 

# 
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Managing the Queue 
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The print service also allows a job to be placed on hold, in order, 
perhaps, to give way to a more urgent one. The suspended job can be 
resumed at any time. 

The Ip command used with these options performs all these tasks, 
followed by one of the following keywords: 

Ip -i print-request -H keyword 

hold Hold the specified job. 
resume Resume a job previously held. 

immediate 

Move the specified job to the top of the queue. 

Users can hold and resume their own print requests. Only the 
superuser can use the immediate keyword for jumping the queue. 

1. Place requests on hold. 

$ Ip -i spock-18 -H hold 
$ Ip ~i spock-19 -H hold 
$ Ipstat -o spock 

spock-18 rimmer 72008 Jun 8 14:57 being held 
spock-19 rimmer 88494 Jun 8 14:58 being held 
$ 

2. Resume a previously held request. 

$ Ip “i spock-19 -H resume 

3. Become superuser. 

4. Place a request at the top of the queue. 

# Ip -i spock-18 -H immediate 
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Setting Printing Priorities 


The Solaris 2.x environment allows users to submit print requests at 
higher or lower priorities. Priorities range from 0 (high) to 39 (low). 
The default priority for all users is 20. 

Examples: 

1. Place an important job at a high priority. 

$ Ip “d sparky -q 0 fastfile 

request id is sparky-86 (1 file(s)) 

$ Ipstat -o 

sparky-86 rimmer 19379 Jun 8 11:45 

spock-84 root 45133 Jun 8 11:45 

spock-85 root 13306 Jun 8 11:45 

$ 

2. Place an unimportant job at a low priority. 

$ Ip -d sparky -q 30 bigfile 

request id is sparky-87 (1 file(s)) 

$ 
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Starting and Stopping the Print Service 


The print service scheduler is automatically started by the 
/etc/init.d/lp script when the system enters run level 2. 
However, if the scheduler is not running, it can be started from the 
command line by entering the following command: 

# /etc/init. d/lp start 

Print services started. 

# 

It is advisable to first check that no scheduler is currently running by 
using the Ipstat command with the -r option. 

# Ipstat -r 

scheduler is running 

# 

To stop the print service, use stop as an argument to the 

/etc/init. d/lp script. 

# /bin/sh /etc/init.d/lp stop 

Print services stopped. 

# 
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Summary 


In this lesson, you learned that: 

B Printers can be grouped into a class, which can then be used as 
a destination for print requests. 

B Default printer destinations can be set using the Ipadmin 
command and shell environment variables. 

B Queued print requests may be moved to another printer, using 
the Ipmove command. 

B Queued print requests can be held, resumed, or printed 
immediately, using the Ip command with the -H option. 

B Users can set high and low printing priorities using the Ip 
command with the -q option. 

B The print scheduler can be restarted, if necessary, using the 

/etc/init. d/lp script. 
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Exercise 3-1 


Write down the commands used to perform the specified tasks. 

1. Identify the steps used to create a printer class called lab. 


2. Identify the command format for moving specific print requests to 
another printer. 


3. Identify the command to define a system-wide default printer. 


4. Name the user environmental variable used to define a default 
printer. 
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Answer Key 
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Lesson 1: The Print Service 


Exercise 1-1 


a. Queuing--The process of lining up jobs. 

b. Tracking—The print service tracks the status of every job to 
allovsr users to remove jobs and system administrators to 
manage jobs. 

c. Fault Notification—When problems occur in the print service, 
error messages are displayed on the system console or mailed 
to the system administrator. 

d. Initialization—The print service initializes a printer before 
sending it a print job to ensure it is in a known state. 

e. Filtering—Certain complex print jobs, such as CAD documents, 
are converted into descriptions the printer can understand. 

2. Printer filters are programs used by the print service to convert the 
content of a request to the content accepted by the destination 
printer. 


a. Solaris 1.x print clients served by Solaris 2.x print servers 

b. Solaris 2.x and SunOS ^.\.x print clients served by a Solaris 2.x 
print server 

c. Solaris 2.x and SunOS 4.1.x print clients served by a SunOS 
4.1.x print server 

4. The IpNet process connects to the listen port monitor on the 
server, which connects the incoming IpNet request to a local 
IpNet process. Once the request has been queued by the local 
IpNet process, it is sent to the printer by the Ipsched daemon. 
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Lesson 2: The Printer Manager 


Exercise 2-1 

1. Connect the printer accordingly and turn it on. 

2. Follow the steps as describe in the "Adding a Local Printer" 
section of this module. 

3. Follow the steps as described in the "Adding Access to a Remote 
Printer" section of this module. 

4. Look at the Printer Manager window to verify that the printer has 
been added. 

5. Use the Ip command to send a file to the printer. 
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Lesson 3: Using LP Commands 


Exercise 3-1 
1 . 

a. Add printers to the class by using the command: 

# Ipadmin -p printer_name -c class_name 

b. Issue the accept command to allow the printer class to accept 
print requests: 

#accept class_name 

c. Check the status of the class by entering the command: 

#Ipstat -t 

2. Ipmove printername-ID other_printername 

3. Ipadmin -d printername 

4. LPDEST 
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Configuring Printers Manually 


The following section provides steps for configurating printers 
manually, and LP command reference tables. 


/. 
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Configuring a Local Printer 

1. Become superuser. Ensure the /usr/lib directory is in your 
command search path. 

# PATH=$PATH:/usr/lib 

2. Change ownership and set permissions on the printer's serial port. 

# chown Ip /dev/term/a 

# chmod 600 /dev/term/a 

3. Use the Ipadmin command to add the printer and associate it 
with a printer port. 

# Ipadmin -p dotty -v /dev/term/a 

-p Indicates the printer name. 

-V Indicates the device used by the printer. 

This command also registers the printer name with the print 
service. From now on, use this name is to identify this printer. 

4. Associate the printer with a content type. 

# Ipadmin -p dotty -I simple 

“I Indicates the content type. 

If the content type is not specified, the system uses the simple 
type, which means the printer can only handle ASCII contents. 

5. Set the line parameters appropriate for the printer. 

# Ipadmin -p dotty -o "stty='1200 evenp'" 

6. Associate the printer with a printer type, if necessary. This enables 
the interface program to perform a better initialization of the 
printer before downloading every request. 

# Ipadmin -p dotty -T proprinter 

7. Allow the printer to accept requests and enable the printer. 

# accept dotty 

# enable dotty 
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Configuring a Local PostScript Printer 


This configuration procedure is very similar to the one for dot-matrix 
printers, with two exceptions. One is the content and printer types are 
specified as PS. The other is the installation of PostScript filters. 

The Ip filters command installs filters on the system by updating 
the filter table with the filter name and description file. 

1. Become superuser. Ensure the /usr/lib directory is in your 
command search path. 

2. Change ownership and set permissions on the printer's serial port. 

# chown Ip /dev/term/a 

# chmod 600 /dev/term/a 

3. Add the printer and associate it with a printer port. 

# Ipadmin -p lasey -v /dev/term/a 

4. Associate the printer with a content and printer t 5 ^es. 

# Ipadmin -p lasey -I PS 

# Ipadmin -p lasey -T PS 

5. Use the Ipf ilter command to register the PostScript filters. 

# cd /etc/lp/fd 

# Ipfilter -f download -F download,fd 

# Ipfilter -f dpost -F dpost.fd 

# Ipfilter -f postdaisy -F postdaisy.fd 

# Ipfilter -f postdmd -F postdmd.fd 

# Ipfilter -f postio -F postio.fd 

# Ipfilter -f postior -F postior.fd 

# Ipfilter -f postmd -F postmd.fd 

# Ipfilter -f postplot -F postplot.fd 

# Ipfilter -f postprint -F postprint.fd 

# Ipfilter “f postreverse -F postreverse.fd 

# Ipfilter “f posttek -F posttek.fd 

6. Allow the printer to accept requests and enable the printer. 

# accept lasey 

# enable lasey 
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Removing a Local Printer 

1. Suspend the queuing of further requests with the reject 
command. 

# reject -r "printer dotty is dovm" dotty 
Options: 

r Indicates a reason message. This message is displayed 

when users issue the Ipstat command. 

dotty The name of the printer to suspend queuing. 

2. Use the disable command to disable the printer or to stop 
printing. 

# disable -W -r "printer dotty is down" dotty 
Options: 

-W Wait until the request currently printing is finished 

before disabling the printer. This option is ignored for 
remote printers. 

-c Cancel the currently printing request (not used in the 
example). This request is restarted when the printer is 
enabled again. The request is ignored when applied to 
remote printers. 

-r Indicates a reason message to be shown when status is 
displayed by Ipstat command. 

dotty The name of the printer to be disabled. 

3. The Ipadmin -x command removes the printer from the print 
service. 

# Ipadmin -x dotty 
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Configuring a 2.x Print Server 


For SunOS 4.1.r/BSD Clients 

1. Use the Ipsystem command to register all print clients with the 
print service. 

# Ipsystem -t bsd bear 
Options: 

-t Indicates the remote system type—s5 or bsd. 

bear The remote system name. 

2. Identify the listen port monitor version number. 

# nlsadmin -V 

4 

3. Use the sacadin command to create an instance of the listen 
port monitor. 

# sacadm -a ~p tcp -t listen \ 

-c "/nsr/lib/saf/listen tcp" -v 4 

4. Use the Ipsystem -A command to obtain the printer server's 
universal address in hexadecimal format. 

# Ipsystem -A 

00020203819d52180000000000000000 

(See the Universal Address explanation on the following page.) 

5. Use the pmadm command to configure the listenBSD service, 
which listens for print requests coming from SunOS 4.1.X/BSD 
clients. 

# pmadm -a -p tcp -s Ipd -i root -v 4 \ 

-m 'nlsadmin -o /var/spool/lp/fifos/listenBSD \ 
-A "\x00020203819d52180000000000000000"' 

The universal address of the print server is required when 
configuring this service. 


Configuring Printers Manually 
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Configuring a 2.x Print Server 


For Solaris 2.A:/System V Clients 


The process of configuring a print server for Solaris/System V clients 
is very similar to the one for SunOS 4.1.x/BSD clients. 

The main differences are the way in which the client systems are 
registered with the print service and the type of services provided by 
the listen port monitor. 

The listen port monitor provides two services: 

listens 5 Handles Solaris 2.x/System V print requests. 

service 0 Handles network requests between Solaris 2.x systems. 

When a print request is detected, it hands control over to 
the listens5 service. 


Universal Address 


The Universal Address represents a protocol-independent code that 
includes the print server's IP address and the printer port numbers: 


\x 0002 

T 

I NET protocol 
family 


0203 

OACE 


819d5218 

Server’s IP 
address in hex 


BSD printer 
port (515) or 
SV listen port 
(2766) 


0000000000000000 


16 zeros for padding 


SunOS 4.1.x print requests are connected to a SimOS 5.1 print server 
via a TCP/IP connection on port number 515. SunOS 5.1 print 
requests are connected to a SunOS 5.1 print server through port 
number 27 66. 
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Configuring a 2.x Print Server 


Universal Address (continued) 

The a(i(iresses returned from the Ipsystem -A command are used 
with the pmadm command to identify the print server's IP address plus 
port numbers 515 and 2766. These addresses are used by the listen 
port monitor to route both print request types to the print service. 


Configuring Printers Manually 
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Configuring a 2.x Print Server 


For Solaris 2.a;/System V Clients 

1. Use the Ipsystem command to register the s5 clients with the 
print service. 

# Ipsystem -t s5 eagle 

2. Use the sacadm command to configure the network listen port 
monitor, if necessary. (This step might have been done in the 
previous procedure). 

# sacadm -a -p tcp -t listen \ 

-c "/nsr/lib/saf/listen tcp" -v 4 

3. Use the pmadm command to add a service that identifies the 
STREAM used by the Ip print service to receive print request 
connections. 

# pmadm -a -p tcp -s Ip -i root -v 4 \ 

-m 'nlsadmin -o /var/spool/lp/fifos/listenSS' 

4. Use the pmadm command to add a service 0, which is the nips 
server, using the listening address for System V print requests. 

# pmadm -a -p tcp -s 0 -i root -v 4 \ 

-m "'nlsadmin -c /usr/lib/saf/nlps_server \ 

-A '\x00020ACE819d52180000000000000000'' " 

Note that the universal address used in this case is slightly 
different than the one specified for the listener of SunOS 4.1.x 
clients. The port number changed from 02 03 to OACE, which 
represents the decimal port number 27 66, the System V listener 
port. 
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Configuring a 2.x Print Client 


Of a SunOS 4.1.X/BSD Server 

When Solaris 2.x print clients send files to a remote SunOS 4.1.x 
PostScript printer, they do not have to specify a PostScript content or 
printer type; nor do they have to register any filters. 

Issue the following commands on the print client: 

1. Use the Ip system command to register the printer server name 
with the print service. 

# Ipsystem -t bsd earth 

2. Use the Ipadmin command to add the printer to the system and 
create a local name for the printer. 

# Ipadmin -p spare -s earth 

-p Indicates local printer name. 

-s system 

Indicates remote system. 

3. Specify the printer's content and type. 

# Ipadmin -p spare -T unknown -I any 

4. Allow the queuing of requests, and enable the printer. 

# aeeept spare 

# enable spare 
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Configuring a 2.x Print Client 

Of a Solaris 2.x/System V Server 


Note that the process of configuring print clients of a Solaris 

2.A:/System V server is very similar to the one shown for SunOS 
4.1.x/BSD servers. The only difference is the value of the -t option 
supplied to the Ipsystem command. 

Issue the following commands on the print client: 

1. Register the print server with the print service. 

# Ipsystem -t s5 pluto 

2. Create a local name for the remote printer. 

# Ipadmin -p spock -s pluto 

3. Set the print type and contents. 

# Ipadmin -p spock -T PS -I PS 

4. Register bundled PostScript filters using the Ipfilter command. 
(See this procedure under Configuring a Local PostScript Printer.) 

5. Allow the printer to accept requests, and enable the printer. 

# accept spock 

# enable spock 
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User Commands 


The user commands of the Solaris 2.x print service are listed below. 
They are located in the /usr/bin directory. 


Command Name 

Description 

ip 

Send file to a printer 

Ipstat 

Display print service status 

cancel 

Cancel a print request 
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Administration Commands 

All LP administration commands are in the /usr/lib directory. 


Command Name 

Description 

accept(IM) 

Enable queuing of print requests 

reject(IM) 

Prevent queuing of further print requests 

Ipadmin(IM) 

Configure and administer print service 

Ipsystem(IM) 

Register remote systems with print 
service 

Ipmove(IM) 

Move requests between destinations 

Ipusers(IM) 

Change user print priority settings 

Ipfilter(IM) 

Register filter definitions with print 
service 
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Configuration Files 


The print service's configuration files are in the /etc/Ip directory. 
The /var/spool/Ip directory is the spooling directory. 


File Name 

Type 

Description 

/etc/lp/Systems 

file 

List of remote hosts registered 
with print service 

/etc/Ip/default 

file 

Contains name of system-wide 
default destination 

/usr/lib/lp/ 

postscript 

directory 

Contains filter description files 

/etc/Ip/filter. 
table 

file 

Printer filter lookup table 

/etc/lp/logs 

symlink 

Symbolic link to /var/ 

Ip/logs 

/etc/lp/printers 

directory 

Contains one sub-directory for 
each configured printer 

/etc/Ip/printers 
pname/ 

configuration 

file 

Configuration file for printer 
pname 

/var/lp/logs 

directory 

Print service log files 

/var/spool/Ip/ 
SCHEDLOCK 

file 

The Ipsched lock file prevents 
more than one instance of the 
Ipsched process 

/var/spool/Ip/ 
system/pstatus 

file 

Contains’the current status of 
print system 

/var/spool/Ip/tmp 

directory 

The s|X)oling directory 
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